BBS Toolkit/BBS Toolkit.iso/doors_1/duel.zip/DUEL.DOC

Text File | 1991-06-29 | 16KB | 528 lines

                 ┌────────────────────────────────────────────┐
                 │                                            │
                 │                  Dice Duel                 │
                 │           =======================          │
                 │                                            │
                 │         A Live Game for Many BBS's         │
                 │                                            │
                 │   Game Release Version 1.0 - 02/25/91      │
                 │                                            │
                 │             (C)opyright 1991               │
                 │                                            │
                 │                   By                       │
                 │                                            │
                 │            SECRET SERVICE BBS              │
                 │                                            │
                 │              Mike Wilson                   │
                 │             P.O. Box 9521                  │
                 │            Huntington, WV                  │
                 │                  25704                     │
                 │                                            │
                 │            BBS [phone]              │
                 │            1200/2400/9600 24 hrs.          │
                 │                                            │
                 │                                            │
                 │                                            │
                 │                                            │
                 └────────────────────────────────────────────┘

























                   Dice Duel   (C)opyright 1991 - Page 1




                                  Warranty


This is product is provided "as is" without warranty of any kind.  The
entire risk as to the results and performance of the program is assumed by
you. Futher more, I the author do not warrant, guarantee, or make any
representations regarding the use of, or the results of the use of the program,
and you rely on the program and results solely at your own risk.  I the author
cannot accept responsibility for system damage, loss of profit, or any other
special, incidental, or consequential damages resulting from the use or
inability to use this product.


                                 Copyright


The Multi-Board Dice Duel live game is distributed as SHAREWARE.
Under this concept you may use the SHAREWARE (unregistered) version for a
reasonable period of time, which I consider to be three weeks, after which you
must either register your copy or discontinue usage.


                               Registration

With registration you will recieve the latest registered copy of Dice Duel
with the ability to download any futher updates from Secret Service BBS
at no extra  cost. You will also recieve any support the author can give
in reference to bugs or other problems that may arise in using the game.

I feel that sysop's have enough expense without charging a high cost for a game
for their users. I have set the cost of registration at $20.00 which I feel
if people will follow the shareware concept will be enough to cover shipping
and handling and encourage me to write more doors.
See register.txt for ordering instructions.


                               Distribution

You are free, in fact encouraged, to distribute the SHAREWARE (unregistered)
version of Multi-board Dice Duel Live Game provided that all files
contained in the original Duel Guppies archive are distributed in their
original unmodified state.



                               Introduction
                                     &
                                How To Play

Dice Duel is an excellent Dice rolling game in which users much fill the
score card to achieve dollar values. Dice are rolled up to three times
then placed on the score card as applicable (Example: If you have three
ones and two fours you could play the dice in the Full House slot on the
score card).  There are three rounds per game and the sysop determines how
many games are allowed each day.






                   Dice Duel   (C)opyright 1991   Page - 2



                          Options and Information

This door game will also create color and mono top 10 bulletins and write them
in directories of your choice written in the .CFG file. The top player of the
previous month is displayed within the bulletins as well as the all time
high scorer.



                      Installation and Setup

Setup of the game is a simple procedure. Create a directory for Dice
Duel and unzip the files in Duel.zip into the directory.
Run Setup.exe and answer the questions that are asked. (If your unsure
of an answer refer to areas described below in the docs).
Once you answer the questions in the setup program set up a batch
file to call it from within your bbs as described in the batch
file section of these docs.

I will describe each file that exists or is created by Setup.exe


Duel.CFG contains:

The Secret Service BBS           <-- Name of BBS
Mike                             <-- Sysop's first name
Wilson                           <-- Sysop's last name
C:\Path\BBSinfo.???              <-- Path and filename for Board Info File
C:\Path\Bulletin.clr   <-- Path & Filename to create COLOR bulletin
C:\Path\Bulletin.asc   <-- Path & Filename to create MONO bulletin
NO                               <-- NO or locked COM PORT Baud Rate
3                      <-- Number of games player is allowed per day

The line above that references the path and name of the board info file
should be the path and file to the file that your particular BBS creates
when it drops out to run a game. This would be:
WILDCAT prior to V3.0 ---> Callinfo.bbs    Spitfire --> SFDoors.dat
GAP or WILDCAT 3.0+ -----> Door.sys        PCBoard -> PCBoard.sys
QuickBBS ---> DorinfoX.Def (The X is 1 or 2 depending on node)

The path to color and mono bulletins can be any valid path and any
valid name that you want the top ten scores bulletins written to.


NOTE FOR MULTI NODES!
You may now have several .cfg files to allow use on multinode systems.
Use the above .cfg format but name each .cfg file differently. Just use
an ASCII format word processor or Copy Con or Edlin. You may call
them what you want as long as you correctly call them from the
batch file command line.

Example:    Node1:     game game.cfg

            Node2:     game game1.cfg


** NOTE: If you run Multi-nodes and use a Non-Standard Port Address
         or IRQ value then read PORT.DOC to set these up!




                   Dice Duel   (C)opyright 1991  Page - 3



Duel.DAT contains:


This file contains the following user data:

"The Champion","02-25-1991","100"

Data has to be kept in this format, but you can delete all lines except for
line number 1 which is the Last Months Champ line. You can alter line 1 but
not remove it. You need to alter line 1's Date form 01-12-1990 to the month
that your setting up this door. For example if it is December just simply
change the Date to 12-01-1990. It doesn't matter if it's the 1st or the 10th,
only the Month (12) will make any difference.



Duel.TXT contains:

This is the instruction file for Duel Guppies. When a user selects the
See Instructions option during the game, this file is read for
instructions. This file MUST BE PRESENT and Not altered in any way for
Duel Guppies to run properly


BOARD.TXT
---------
Don't worry about this file. It is created when you run setup.exe
This file tells the game which BBS Software you are running and
tells it to read the correct board file. THERE SHOULD NOT BE A
BOARD.TXT FILE IN THE GAME DIRECTORY IF YOUR RUNNING A WILDCAT
Version prior to 3.0!
The game looks for this file and defaults to Wildcat if it isn't
found.
For other boards it will contain one line with one of the following:
QuickBBS --------> QBBS         GAP or Wildcat 3.0+ ------> GAP
PCBoard ---------> PCB          Spitfire ------> SPITFIRE



PORT.DOC
---------
Read this only if you run coms 3 or 4 as Non-standard port addresses
or non-standard IRQ's.


                          List of Files In Archive

The following files are either found in your Dice Duel .ZIP or will be
created during the runtime execution of the game.


Duel.EXE    <--- Executable Program.

Setup.exe    <--- Setup program for Duel Guppies

Duel.DAT    <--- Store User's Name, Last Play Date & Score.

Duel.TXT    <--- Instructions Used By Program.

BULLET##.SCR *<--- COLOR Bulletin


                   Dice Duel  (C)opyright 1991  Page - 4

BULLET##.BBS *<--- MONO Bulletin

Duel.DOC    <--- This File.

Champion.txt <--- The file that stores the all time champion score

Register.txt <--- Registration Information

Port.doc <------- Information on setting up Non-standard Ports & IRQ's

* DENOTES that file is created during RUN-TIME.

                                  Batch Files
                               =================

Be sure that you have edited or created the Duel.CFG file with the correct
information as described earlier in these docs. The individual setups do not
repeat this necessary process.

Wildcat! 1.13 & 2.0+ Setup:
---------------------------
First, create your DOOR##.BAT (2.0+) or LIVE##.BAT (1.13) like this eample:

   ECHO OFF
   CD \WILDCAT\DOORS\Duel
   Duel Duel.CFG
   CD \WILDCAT
   CAT.BAT

place this batch file in your Node# directory if running Multi-Nodes or in
your Wildcat (default) directory if single node.

Second, Create a sub-directory for the door program such as in the following
example:

C:\WILDCAT\DOORS\Duel

Third, put the Dice Duel game files in the \WILDCAT\DOORS\Duel
directory.

Forth, add this game to your live program menu for user selection and your
ready to run the door.

If this is a little unclear then please read your systems documentation for
more detailed instructions.

If you use a door monitoring program then read their documentation for
their specific setup.


Gap Setup:
----------
First, add the number and name of the door to your menu. This will allow the
user to select the door by number.

Second, edit or create the file called DOORS.DAT which is normally in the GEN
directory. Following is an example line to add:

   DD 10

where 'DD' stands for the name of the batch file (shown below) to invoke the
the door and '10' is the required security level.


                   Dice Duel   (C)opyright 1991  Page - 5

Third, create a sub-directory for Dice Duel to be placed in. And example
would be:

C:\GAP\Duel

place all the files in the Duel.ZIP archive inside this directory.

Forth, create a batch file called Duel which should be placed in the
default directory. Following is example contents of this file:

   ECHO OFF
   CD\GAP\Duel
   Duel Duel.CFG
   CD\GAP
   GAP

the last line in the Duel file should invoke the batch file which loads
the GAP BBS system.

If this is a little unclear then please read your systems documentation for
more detailed instructions.

If you use a door monitoring program then read their documentation for
their specific setup.



Spitfire Setup:
---------------
First edit your SFDOOR.MNU and add the following line. If you are not running
and doors at this time you will need to create this file.

   DiceDuel, 10

   Where DiceDuel is the name of the door to appear on your menu and the
   10
   is the lowest security level that will be allowed to enter the door. Don't
   forget the comma (,) after the name.

Second create a sub-directory to place the door game in. In this example we
will use 'C:\SF\DOOR_A' for the game directory.


Third move all the files in the Duel.ZIP archive into this directory.

Forth edit your SF.BAT file adding the following lines.

:DOOR_A
   CD\SF\DOORS_A
   Duel Duel.CFG
   CD\SF
   GOTO LOOP

Fifth, rerun Sf.BAT and your ready to begin play.

If this is a little unclear then please read your systems documentation for
more detailed instructions.

If you use a door monitoring program then read their documentation for
their specific setup.




                   Dice Duel   (C)opyright 1991  Page - 6

PCBoard 14.0+ Setup:
--------------------
First, edit your DOORS and DOORSG file so that it shows Duel with the door
number relating to it's position in DOORS.DAT.

Second, edit the DOORS.DAT file so that it includes Duel.

Third, create a sub-directory for Dice Duel to be placed in. And example
would be:

C:\PCB\Duel

place all the files in the Duel.ZIP archive inside this directory.

Forth, create a batch file called Duel which should be placed in the
default directory. Following is example contents of this file:

   ECHO OFF
   CD\PCB\Duel
   Duel Duel.CFG
   CD\PCB
   BOARD

the last line in the Duel file should invoke the batch file which loads
the PCboard BBS system.

If this is a little unclear then please read your systems documentation for
more detailed instructions.

If you use a door monitoring program then read their documentation for
their specific setup.



QuickBBS Setup:
---------------
First, add the game to your games menu and select the correct type for doors.

Second, create a sub-directory for the game and move all the files from the
zip file to this directory.

Third, the game reads the file DORINFOx.DEF. Where 'x' is the node number.
Since QuickBBS only supports one node at this time then this file should be
'DORINFO1.DEF'. This file's drive\path\filename should be on the third line
of the configuration file.

   Note: It was told to me that the upcoming 3.0 version of QucikBBS will
         support Multi-Nodes and that the 'DORINFOx.DEF' will be changed
         to 'DORINFxx.DEF' to support Multi-Nodes. This game is written
         where you can specify this new name as well as any others.

Forth, create a batch file called Duel which should be placed in the
default directory. Following is example contents of this file:

   ECHO OFF
   CD\QUICKBBS\Duel
   Duel Duel.CFG
   CD\QUICKBBS
   QBBS.BAT

the last line in the Duel file should invoke the batch file which loads
the QuickBBS system.


              Dice Duel  (C)opyright 1991  Page - 7

If this is a little unclear then please read your systems documentation for
more detailed instructions.

If you use a door monitoring program then read their documentation for
their specific setup.



                            Technical Support

If you have problems with the  Dice Duel live game you may
contact Mike Wilson at the Secret Service BBS 24 hours per day.
PCRelay ID: ->SECRET             FIDO 1:262/29





                              Order Information


Just mail $20.00 Check or Money Order or Cash to:

Mike Wilson
P.O. Box 9521
Huntington, WV
            25704

Make Checks out to Mike Wilson.


Thank you for trying Dice Duel and look for more games and utilities
in the near future.

Special thanks to Jeff Sumberg for some great C routines used in this door!





























                   Dice Duel   (C)opyright 1991  Page - 8